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PREFACE 


This document describes the features and operation of the File 
Dump (FILDMP) utility program. 

FILDMP is used to display files or selected portions of mass 
storage. The user is provided with printed copy for visual inspection. 
FILDMP is loaded and called as a DOS/BATCH system program. 

This document assumes familiarity with the DOS /BATCH Monitor, 
Assembler (MACRO-11) , Linker (LINK) , and file utility package (PIP) . 


Documentation Conventions 

As shown in the examples herein, command strings are 
typed in response to the underlined ^ and $_ and £ 
characters . 

All command strings are terminated with the RETURN 
key . 


NOTE 

The software described in this manual 
is furnished to purchaser under a li- 
cense for use on a single computer 
system and can be copied (with inclu- 
sion of DEC 1 s copyright notice) only 
for use in such system, except as may 
otherwise be provided in writing by DEC. 


This document is for information pur- 
poses and is subject to change without 
notice . 


DEC assumes no responsibility for the 
use or reliability of its software on 
equipment which is not supplied by DEC. 
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CHAPTER 1 


AN INTRODUCTION TO FILDMP 


1.1 INTRODUCTION 

File Dump (FILDMP) is a utility program for use with the PDP-11 
Disk Operating System (DOS/BATCH) . It can be used to enhance the 
debugging of programs by providing a printed copy of the contents 
of all or specific blocks of a file for visual inspection. 

Printout of a file or block (s) of data can be directed from an 
input device to any device capable of ASCII output. 

FILDMP takes its input either as filenames or mass storage block 
numbers, and outputs a dump in various formats. The printed dump is 
in a readable format. FILDMP is device independent in that the output 
can be stored on disk or tape for later printing. 

FILDMP command strings are interpreted by the DOS/BATCH Command 
String Interpreter (CSI) , as explained in the DOS/BATCH Monitor 
Programmer's Manual. For example, the general format of a FILDMP 
command string is: 

output file specif ication (s) <input file specification 
or 

outdev: filename . ext/switch<indev : filename . ext/switch 

The output device, outdev:, on which the data is to appear is usually 
KB: (teleprinter) or LP : (line printer), but can be written as a file 
on any mass storage device for later printing. /switch represents 
FILDMP 1 s switch options (explained later). The input device, indev: , 
is the device on which the file is stored (the DOS/BATCH system 
device is assumed if no input device is specified) . Note that all 
keyboard command strings are terminated with the RETURN key, which 
is non-printing. 

There may be any number of output file specifications? including 
none, in which case no output is generated. There must be exactly 
one input file specification. The entire command string must be on 
one line, i.e., no more than 72 decimal characters, the length of a 
teleprinter line. 
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The CTRL/U key combination can be used to delete the command 
string on the line on which it is typed. When used, it is echoed as 
fU, £he line (command string) is ignored, and FILDMP prints another # 
and waits for the next command. 

1.2 RUNNING FILDMP 


FILDMP is loaded as a DOS/BATCH system program (see the DOS/BATCH 
System Manager's Guide). It can then be called into core and executed 
with the DOS/BATCH Monitor RUN command. For example: 

$RUN FILDMP 
FILDMP Vxxx 
# 

FILDMP identifies itself and prints #, indicating its readiness to 
accept a user command string from the teleprinter keyboard. 



CHAPTER 2 


SWITCHES 


FILDMP operations are controlled with switches in the command 
string. Switches are expressed using a slash and two letters, as 
shown below. There are two types of switches: input and output. 

2.1 INPUT SWITCHES 


Input switches are used to: 

1. Specify the format in which data is to be read. 

2. Determine the mass storage block numbers on 
which a file is stored, 

3. Specify the block or group of blocks to be dumped. 

Input switches should appear only in the input field of the command 
string, i.e., to the right of the < symbol. They are: 


/BL: read specified blocks of mass storage. /BL: 

requires at least one value (block number) , 
and will accept at most two values. The 
syntax for the /BL: switch is: 

/BL : n or /BL:n:m 

where n and m are octal block numbers. 

/CH causes FILDMP to obtain the numbers of the 

blocks which are allocated to the specified 
file. The input device must be a directory- 
structured device. 

/FA read the input file in formatted ASCII mode. 

/FB read the input file in formatted binary mode. 


FILDMP can read data in any of three modes : 


Unformatted binary 
Formatted binary 
Formatted ASCII 


default mode 

/FB 

/FA 


When no input switch is specified, data is read in unformatted 
binary mode. Unformatted binary mode is always assumed with the /BL 
and /CH switches. 
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Only one type of input switch can appear in a command string. 
For example: 


DT: FILE. EXT/FA 


is legal , but 


DT : FILE . EXT/FA/CH 


is not. 


The /BL: switch can appear more than once in a command string. 

For example: 

DT : /BL : 1/BL : 7 : 13/BL : 22 

is legal, but 

DT: /BL : 2 3/FA 

is not because only one type of input switch can appear in a command 
string. In the last example, block 23 will be dumped as directed fol- 
lowed by an error message when /FA is encountered. 


2 . 2 OUTPUT SWITCHES 


Output switches are used to specify the format in which the data 
is to be dumped. They should appear only in the output field of the 
command string, i.e., to the left of the < symbol. They are: 


/AS read successive bytes of the input file or 

mass storage block and output each byte as 
if it were a single ASCII character. The 
ASCII character set which FILDMP considers 
printable is (octal) 40 through 137 and 240 
through 337. Any value outside these ranges 
is printed as if it were 137, a special print- 
ing character; for example, a left arrow or a 
heart-shaped character. 

/BY output the input file or mass storage block (s) 

as a sequence of octal bytes. 

/OC output the input file or mass storage block (s) 

as a sequence of octal words. 
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/RA read successive words of the input file or mass 

storage block (s) , consider each word as a three- 
character, packed Radix - 50 entity, and unpack 
and output it as such. 

When no output switch is specified, the /OC switch is assumed. 

Output switches can be used to direct FILDMP to perform certain 
modes of translation, e.g., a binary file can be dumped in ASCII. 
However, the /CH switch overrides any output switch and causes output 
to appear in octal words. 

Multiple output file specifications are allowed and, in fact, 
common. For example, to dump FILE. EXT (a file written in formatted 
ASCII mode) in octal words and ASCII characters, use the following 
command string. 

LP : /OC, LP: /AS <FILE. EXT/FA 

where the line printer is the output device and FILE. EXT is on the 
system disk. In the above example, FILE. EXT is read in formatted 
ASCII mode and dumped in octal words, and then read in formatted 
ASCII mode and dumped as ASCII characters. If, for example, FILE. EXT 
were on paper tape, it would be necessary to reload the paper tape 
prior to generating the second output. The command string would be: 

LP : /OC , LP : /AS < PR : /FA 

The command string: 

LP : /BY , KB : /RA<DF : /BL : 3/BL : 1 7 : 2 1 

directs FILDMP to dump disk (DF:) blocks 3, 17, 20, and 21 on the 
line printer in octal byte format, and then on the teleprinter in 
unpacked Radix- 5 )2f format . 

2.3 OUTPUT FORMATS 


The output or printed format of the dump differs slightly, de- 
pending on the switch used. If no input switch (implied unformatted 
binary mode) or the /BL: switch is specified, the leftmost column of 
the output is the byte count of the file or mass storage block. If 
the /FA or /FB switch is specified, the leftmost column of the output 
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is the line number of the file. The physical output line which begins 
with the line number contains the status and mode bytes and the byte 
count word as well. 

Read errors are indicated by an E between the line number and the 
status byte. The status byte gives detailed information concerning 
the error. The E error message appears only on dumps where the input 
is read in a formatted mode. 

If /CH appears in the input field, the output is the block num- 
bers, in sequential order, occupied by the file. No byte count or 
line count appears. 

The output of FILDMP contains a form of identifier. If /BL: 
appears, FILDMP prints the device name and block number (in octal) 
prior to dumping any given block. Otherwise, the input filename and 
extension, as specified in the command input, will appear, followed by: 

(ASCII) if the /AS switch is used 

(BYTES) if the /BY switch is used 

(CHAIN) if the /CH switch is used 

(OCTAL) if the /OC switch is used or assumed 

(RAD50) if the /RA switch is used 

If the input file were read as a file (i.e., /FA, /FB, or no 
switch) , FILDMP terminates its output with: 

END OF FILE 

The END OF FILE message does not appear on those dumps which use the 
./CH or /BL switch. 

When /BL: is used, FILDMP formats the output so that page bound- 
aries do not appear in the middle of blocks, yet tries to waste as 
little paper as possible. Thus, if the input device has a 256 ^ word 
block size, there will be one per page? 128 word blocks print two per 
page? 64^ word blocks print four per page, and 32^ word blocks print 
six per page. 

2.4 DUMPING ENTIRE FILES 

Unless the /BL: switch (see Section 2.6 ) is specified, FILDMP 
dumps the entire file indicated. When FILDMP encounters an end-of-file 
(EOF) , it prints 


END OF FILE 
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closes and releases all files , and then prints # to indicate readiness 
for another command string. 

The dumping of lengthy files should, where possible, be performed 
on the line printer; which is impressively faster than the teleprinter 

Dumps to the teleprinter can be interrupted and terminated by 
typing the CTRL/C key combination. When CTRL/C is typed during a dump 
FILDMP pauses, and a period is printed. At this time , the user can: 

1. Type the RETURN key to resume the output. 

2. Type RE (restart) to abort the output and return con- 
trol to FILDMP, which prints # and waits for the next 
command . 

Note, however, that steps 1 and 2 above apply primarily to the tele- 
printer. The purpose of CTRL/C during a dump is to interrupt time- 
consuming printout, whereas the speed of the line printer obviates the 
need for this feature. 

2.5 DETERMINING FILE BLOCKS, /CH 

The /CH switch is helpful in determining the block size of a pro- 
gram and in pinpointing certain blocks of data for future referencing 
with other FILDMP operations. For example: 

jfKB : < DEMO/ CH 

DEMO (CHAIN) 

002252 002262 

JfLP : < S I ZE/CH 

SIZE (CHAIN) 

001700 001705 001712 001717 ... 

001750 001755 001762 ••• 

002020 

_# 

DEMO is a file which is stored in the two blocks numbered 002252 and 
002262. SIZE is a file which is stored in the 17 blocks numbered 
as shown . 
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The /CH switch does not require an output switch — block numbers 
are always printed in octal words because they are referenced in octal 
words with the /BL: switch. 

When using the /CH option, if FILDMP cannot find the input file, 
then the error message S206 (no input file) is printed, followed by #. 

(In no other case does FILDMP attempt to predetermine the existence of 
its input file, i.e., if the input file is not found, F012 results.) 

2 ■ 6 DUMPING BLOCKS O F DATA, /BL: 

The block switch, /BL: , is used to indicate the dumping of a speci- 
fic block or group of contiguous blocks. More than one /BL: switch 
can be specified in a command string. Each /BL: switch requires at 
least one and at most two arguments (block numbers) , and each argument 
is preceded by a colon* For example, the following command string 
dumps the contents of block 2252 in ASCII characters: 

JLP : /AS < DF : /BL : 2 2 5 2 

The following command string dumps blocks 17 through 43 in octal 
words : 


JLP : /0C<DT1 : /BL : 17 : 43 

The following command string dumps blocks 15 through 21, block 32, 
and blocks 113 through 121 in octal bytes: 

_#LP : /BY<DK : /BL : 15 : 21/BL : 32/BL : 113 : 121 

The /BL: switch reads input in unformatted binary only. 

The following command string dumps blocks 70 and 100 in octal and 
then in Radix-50. 

_#LP : /OC , LP : /RA< DT : /BL : 70/BL : 100 
2 . 7 DUMPING RADIX- 50 FORMATTED DATA, /RA 

The /RA switch can be used to dump Radix-50 formatted data in 
ASCII characters. The /RA switch causes FILDMP to unpack the data 
(three ASCII characters are packed into one word) . 
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This switch can be useful when "looking" at the data stored in 
Radix-5J2f format, e.g., internal directories, etc. 

The /RA switch can be used alone or with the /FA, /FB, or /BL: 
switch. For example: 

#LP:/RA</BL:2:3 

FILDMP would dump blocks 2 and 3 of the DOS/BATCH system device in 
unpacked Radix-50 format. 
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CHAPTER 3 


EXAMPLES 


The following example is not intended to be a practical example 
of the uses of FILDMP. Rather it is intended to show as many examples 
of the FILDMP options, output formats, and error notations as possible. 


The FORTRAN source program RAD50.F4, listed below, writes 30 
records of 12 words each containing the characters A-Z and 0-9 in 
packed RADIX-50 format. The output is to a file named FOR001.DAT on 
the system device. The RADIX-50 packing procedure is described on 
page A-l of the DOS/BATCH Monitor Programmer's Manual. The CALL 
SETERR requests that the overflow into bit 15 (the sign bit) be 
ignored while the RADIX-50 characters are being packed. 


DIMENSION I N < 2 6 ) 

DIMENSION I OUT < 12) 

DEFINE FILE 1< 30, 12, U, I ERR) 

CRLL SETERR<3,-1) 

IF IF -48 
DO 5 J=l, 26 
5 I N < J ) s J 

DO 10 J = 2 ? , 36 
10 IN <J)=J+3 

DO 15 J = l,12 
l-< J-l)*3+l 

15 I0UT<J)=<<IN<I)*IFIF)+3N<I+1 ) ) * I F I F + 1 N < I + 2 ) 

DO 20 J=l, 30 

N R I T E < 1 '' J ) <I0UT<I), 1 = 1, 12) 

20 CONTINUE 

CRLL EXIT 
END 


The FILDMP command string shown below is used to get an ASCII 
dump of the source file RAD50.F4. The resulting output follows. 
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#KB.VR5< 


RRD50. F 4 


R ft D 5 0 . F 4 < fl 5 C 1 1 ) 


0000000 

-D 

IN 

EN 

51 

ON 

I 

N< 

36 

0000020 

> _ 



DI 

ME 

NS 

10 

N 

10 

0000040 

UT 

<1 

2) 


-D 

EF 

IN 

E 

0000060 

FI 

LE 

1 

<3 

0 1 

12 

, U 

, I 

0000100 

ER 

R > 

_ _ 

-C 

RL 

L 

SE 

TE 

0000120 

RR 

<3 

; “ 

i:> 


-1 

FI 

F = 

0000140 

40 

_ _ 

-D 

0 

5 

J* 

1 , 

26 

0000160 



5_ 

IN 

< j 

) = 

J. 

_ _ 

DO 

0000200 

1 

0 

J = 

2? 

, 3 

6_ 

.1 

0. 

0000220 

IN 

< J 

') = 

J4 

3- 

_ — 

DO 

1 

0000240 

5 

J = 

1 , 

12 

_ _ 

.1 

= < 

J- 

0000260 

1> 

*3 

+ 1 

_ _ 

15 

- 1 

OU 

T < 

0000300 


= < 

<1 

N < 

I> 

I 

Fl 

F) 

0000320 

+ 1 

N ( 

1 + 

1> 

;> * 

IF 

IF 

41 

0000340 

N< 

1 + 

2 > 

„ 

-D 

0 

20 

J 

0000360 

= 1 

> 3 

0 _ 

_ — 

WR 

IT 

E < 

1-' 

0000400 

J> 


ID 

UT 

<1 

)# 

1 = 

1, 

0000420 

12 

)_ 

_ 2 

0 _ 

CO 

NT 

IN 

UE 

0000440 

__ __ 

_C 

RL 

L 

EX 

IT 


-E 


0600460 ND 

END OF FILE 


The FILDMP command string shown below is used to get a byte 
dump of the source file. The resulting output follows. 


#KB.VBV<RRD50. F4 


RRD50 

. F 4 

< B V T E 5 > 













0000000 

011 

104 

111 

115 

105 

116 

123 

111 

117 

116 

040 

111 

116 

050 

063 

066 

0000020 

051 

015 

012 

011 

104 

111 

115 

105 

116 

123 

111 

117 

116 

040 



0000040 

125 

124 

050 

061 

062 

051 

015 

012 

011 

104 

105 

106 





0000060 

106 

111 

114 

105 

040 

061 

050 

063 

060 

054 







0000100 

105 

122 

122 

051 

815 

012 

011 

103 









0000120 

122 

122 

050 

063 

054 

055 











0000140 

0000160 

064 

015 

060 

012 

015 

012 



• 






111 

106 

106 

@51 





• 






053 

. 1 . 1 1 








• 




117 

040 

062 

060 

040 

1:12 










127 

122 

111 

124 

105 

050 

061 

047 








125 

124 

050 

111 

051 

054 

111 

075 

061 

054 






012 

062 

060 

011 

103 

117 

116 

124 

111 

116 

125 

105 




011 

183 

101 

114 

114 

040 

105 

130 

111 

124 

015 

012 

011 

105 

0000460 

116 

104 

015 

012 













END 

OF 

FILE 
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The FILDMP command string shown below is used to get an octal 
dump of the source file. The resulting output follows. 


#KB.VOC<RfiD50. F4 


RRB50 

. F4 

< 0 C T ft L > 







0000000 

0000020 

0000040 

0000060 

042011 

006451 

052125 

044566 

646511 

004412 

030456 

642514 

047165 

044564 

624462 

644523 

642515 

005615 

• 

• 

047117 

051516 

644440 

847511 

624116 

033063 

0000440 

0000460 

005015 

042116 

641411 

065015 

031612 

046161 

• 

604466 

026114 

044456 

647563 

054165 

626051 

652116 

652111 

024105 

636511 

047111 

065015 

823461 

026661 

042525 

042411 


END OF FILE 


After the source file is compiled to an object file, RAD50.OBJ, 
the numbers of the physical blocks on the system device that contain 
the file are determined by use of the following FILDMP command: 


#KB : <RRB50. OB J/CH 


RRD50 .OBJ < CH'fi IN) 

000725 001625 601026 06.1027 
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To dump selected blocks of the object file in octal format (the 
default output format) the following FILDMP command is used: 


#KB : < R fi D 5 0 . OBJ/BL : 725/BL : 1025 


OK 000725 < 0CTRL ) 


0000000 

001025 

000001 

000056 

000001 

050561 

055740 

000000 

000000 

0000020 

127401 

0O7624 

000410 

000000 

021411 

076400 

002100 

0 0 0 0 0 0 

0000040 

07363 4 

021642 

002100 

000000 

124471 

046340 



0000060 

000235 

000001 

000056 

000001 

124473 

115520 



0000100 

124503 

070261 


• 

• 









# 



000000 

000000 






000000 

000003 

0 0 0 0 0 0 

0 0 1 0 0 0 




001006 

000204 

000001 

000056 

000004 

003004 

0000740 

125517 

047000 

004002 

125361 

050500 

011002 

125675 

065100 

0000760 

013002 

124545 

023364 

014001 

001000 

01500:1 

001002 

016001 


OK 

001025 

< 0 C T R L ) 





0000B00 

0000020 

0000040 

0000060 

001026 

000034 

000000 

065100 

001004 

000000 

000402 

004001 

017001 

000004 

000224 

001006 

000772 

000001 

000133 

000000 

000001 000032 000003 

0 0 0 6 0 0 


0 000 P 40 

000000 

000003 

000003 

000000 

m 

000222 

001042 

064400 

000000 

000000 

012001 

000013 

000014 

125675 

001022 

000000 

000374 

065100 
000077 
0010 22 
000001 

0000P60 

000054 

000004 

002002 

125675 

065100 

004002 

124527 

074701 
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The data file containing the packed RADIX-50 characters , 
FOR001.DAT, may be dumped in unpacked RADIX-50 format by using the 
following FILDMP command string. The resulting output follows. 


#KB.VRA<FOR001. DfiT 


FOR001. DfiT < RfiD50 ) 


0000000 ABC 

DEF 

GHI 

JKL 

MNO 

PGR 

STU 

VWX 

0000020 VZ0 

122 

456 

789 

ABC 

DEF 

GHI 

JKL 

0000040 UNO 

PGR 

5 TU 

VHX 

VZ@ 

122 

456 

789 

0000060 ABC 

DEF 

GHI 

JKL 

fINO 

PGR 



0000100 VZ0 

122 

4 56 

789 






0000120 mo PGR 


0001260 VZ0 122 

0001200 mo PGR 

0001220 
0001240 
0001260 
0001400 
0001420 
0001440 
0001460 
0001500 
0001520 
0001540 
0001560 
0001600 
0001620 
0001640 
0001660 
0001700 
0001720 
0001740 
0001760 

END OF FILE 


GHI 

JKL 

VZ6 

MNO 

456 

789 

ABC 

STU 

vwx 

VZ0 



GHI 

JKL 

122 

456 

789 

PGR 

STU 

VWX 

DEF 

GHI 

JKL 

122 

456 

789 
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To 

dump the 

data file in octal (to 

see the 

packed : 

RADIX-50 


format) 

the FILDMP command shown 

below : 

is used. 

The associated 


output follows. 








tH(B:/OC<FOR0Bl. 

DRT 







FOR001. DRT < 0 C T fl L > 







0000000 

002222 

014716 

026411 

040104 

851577 

062272 

074765 

106460 

0000020 

120156 

142241 

155024 

166527 

002222 

014716 

026411 

040104 

0000040 

051577 

062272 

074765 

106460 

120156 

142241 



0000060 

002222 

014716 

026411 

040104 





0000100 

120156 

142241 


• 

• 









• 



000000 

000000 






000000 

000000 

000000 

000000 




000000 

000000 

000000 

000000 

0 0 0 0 0 0 

000000 

0001740 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

0001760 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 


END OF FILE 


If the data file is mistakenly specified as being in formatted 
binary (the file is actually in unformatted binary, the FILDMP default 
input file format) FILDMP encounters errors as it tries to read the 
input file. An example of this FILDMP command string and the resulting 
output are shown below. 


ttKB:<FGR001. DFFIYFB 


FORG01. DRT < OCTRL ) 

000000 E004 001 000000 
000001 E004 001 000000 
000002 E0G4 001 
000002 

£100004 # 


000000 
E004 001 000000 
000262 E004 001 000000 
000262 E004 001 000000 


END OF FILE 
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CHAPTER 4 


FILDMP ERROR MESSAGES 


The following error messages are used by FILDMP. 


Message 

S202 


S2 03 


S205 


S206 

S256 


Most Probable Cause 

An error occurred during reading of the command 
input. (Recall that the maximum line length is 
72 decimal characters.) 

An error occurred in the switches. Either: 

1) FILDMP could not understand the switch; 

2) too many switches on input or output; 

3) no value or more than two values to /BL: 

More than one input file specification in the 
command string. This error will appear even if 
the extraneous input file specifications are null. 

FILDMP could not find the input file to /CH. 

A /CH request accompanied a file specification 
in which the input device is not directory struc- 
ture^ or input device will not support input. 


Other error messages can occur by virtue of the user having requested 
FILDMP to do something illegal. For example, DOS/BATCH will issue an 
F01 2 message if FILDMP attempts to read a file which is protected so 
that the current user cannot access it. The user should consult the 
appropriate DOS/BATCH documentation upon receiving such error messages. 


FILDMP does not terminate processing (or inform the user via S202 ) 
if a read error occurs while the input file is being read. The user 
should search the dump for E flags, and then consult the status byte. 
Recall that the E flag appears physically between the line number and 
the status byte number on dumps of files which were read in either 
formatted ASCII or formatted binary mode. 


Errors detected during the command string input and during the 
dumping process will result in standard DOS/BATCH Monitor error 
message printout. See Appendix F of the DOS/BATCH Monitor Programmer's 
Manual for a complete list and explanation of the error codes. 
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CHAPTER 5 


ASSEMBLING AND LINKING FILDMP 


Source modules of the FILDMP program are available on DECtape 
and Mag tape. Assembling and linking FILDMP can be done in various 
ways, using virtually any combination of DECtape, Mag tape, and disk. 
However, the most efficient method is to PIP the source module from 
DECtape or Mag tape onto the DOS/BATCH system device (disk) and then 
assemble and link from disk to disk, as explained in this chapter. 

FILDMP is assembled and linked using the Macro Assembler and 
Link Linker. The following procedures assume that these two system 
programs are available via the DOS/BATCH Monitor RUN command, and that 
the user is logged in and running under the DOS/BATCH Monitor. This 
chapter assumes that the reader is familiar with the DOS/BATCH Monitor, 
Macro Assembler, Link Linker, and PIP File Utility Package. 

The command strings shown below direct the printing of assembly 
listings, symbol tables, and linking load maps to the line printer 
(LP:); if no line printer exists in the system configuration, omit 
LP: in the command strings. 


NOTE 

As shown in the following examples, command 
strings are typed in response to the under- 
lined and £ and £ characters. All command 
strings are terminated with the RETURN key. 


5.1 LOADING FILDMP SOURCE MODULE 


The PIP File Utility Package is used to load the FILDMP source 
module (FILDMP. MAC) onto the DOS/BATCH system device from DECtape or 
Mag tape. In response to the DOS/BATCH Monitor* s dollar sign ($) 
run PIP. For example: 

$_RUN PIP 
PIP-11 Vxxx 
i 

PIP is loaded into core, identifies itself, and prints # to indicate 
its readiness to accept the user's command string. 
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To load from DECtape go to Section 5.1.1. 

To load from Mag tape go to Section 5.1.2. 

5.1.1 From DECtape 

1. Mount the DECtape containing the FILDMP source 
module , FILDMP. MAC on DECtape unit 0 . 

2. Set the REMOTE/OFF/LOCAL switch to REMOTE. 

3. Type, in response to PIP's # sign: 

fFILDMP . MAC<DT0 : FILDMP . MAC 

£ 

The FILDMP source module is copied from DT0 to disk. 

4 . Return to the Monitor by typing the CTRL/C combination 
and clear core with the KILL command. For example: 

£ *3 

^KI 

$ 

Now proceed to Section 5.2 for assembling procedures. 


5.1.2 From Mag Tape 


The FILDMP source module is on Mag tape. 


1. Mount magtape on MT0: Put it on line. 
Respond to PIP's # by typing: 


£F I L DMP . MAC < MT0 : F I LDMP . MAC 
# 


The FILDMP source module is now on the DOS/BATCH system device . 

2. Return to the Monitor by typing the CTRL/C combination and 
clear core with the KILL command. For example: 

£4C 

jl ki 

$ 


Now proceed to Section 5.2 for assembling procedures. 
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5.2 ASSEMBLING FILDMP 


In response to Monitor's dollar sign ($) run the Macro Assembler. 
For example; 


$RUN MACRO 
MACRO Vxxx 
# 


The Assembler is loaded into core, identifies itself, and prints # 
to indicate its readiness to accept the user's command string. 

1. In response to MACRO'S # sign, type: 

#FILDMP . OBJ , LP : <FILDMP . MAC 
i 

FILDMP is assembled with no errors. The object module, FILDMP. OBJ, 
is on the DOS/BATCH system device, and the listing and symbol table 
are on the line printer. 

2 . Return to the Monitor by typing the CTRL/C combination 
and clear core with the KILL command. For example: 

i*c 

• Kl 

$ 

Now proceed to Section 5.3 for linking procedures. 

5.3 LINKING FILDMP 


In response to Monitor's dollar sign ($) run the Link Linker. 
For example: 

$RUN LINK 
LINK Vxxx 

£ 

The Linker is loaded into core, identifies itself, and prints # to 
indicate its readiness to accept the user's command string. 

When linking FILDMP, the top address 37450 should be used, as 
shown in Step 1. 
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1. In response to LINK'S # sign, type: 

# FILDMP . LDA , LP : <FILDMP . OB J/T : 37450/E 
i 

FILDMP is linked. The load module, FILDMP . LDA, is on the DOS system 
device and the load map is on the line printer. Link re-identif ies 
itself and waits for the user's next command string. 

2. Return to the Monitor by typing the CTRL/C combination 
and clear core with the KILL command. For example: 

*iC 

jl ki 

$ 

Having progressed through the loading, assembling, and linking 
procedures as described above, the DOS/BATCH system device contains 
the FILDMP source and object modules. These modules have no useful 
purpose and should be deleted from the disk using PIP. For example: 

$RUN PIP 
PIP-11 Vxxx 

#FILDMP . MAC , FILDMP . OBJ/DE 

¥ 

The # command string above will delete the FILDMP source and object 
modules from the DOS/BATCH system device. 

Return to the Monitor by typing the CTRL/C key combination and 
clear core with the KILL command. For example: 

£-tC 

$ 

FILDMP is now on the system device, and can be run using the 
Monitor RUN command. Unless FILDMP was put on the system as a system 
device (see the DOS/BATCH System Manager's Guide), the user must 
specify in the command string to run FILDMP the User Identification 
Code (UIC) under which FILDMP was assembled and linked. 
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CHAPTER 6 


SUMMARY OF SWITCHES 


6 . 1 INPUT SWITCHES 


Switch 

Name 

Example 

Operation 

/BL: 

Block 

LP : < DTI : /BL : 3 : 7 

Dumps blocks 3 , 4, 5, 6, and 7 
from DTI to line printer in octal 
word format. 

/CH 

Chain 

KB :< DK0 : FILE/CH 

Lists on the teleprinter the num- 
bers of the blocks which FILE 
occupies . 

/FA 

Formatted 

ASCII 

LP : < DK0 : FILE/FA 

Dumps FILE to the line printer 
in octal word format, but reads 
FILE in formatted ASCII mode. 

/FB 

Formatted 

Binary 

LP s < DF : FILE/FB 

Dumps FILE to the line printer 
in octal word format, but reads 
FILE in formatted binary mode. 

none 

Unformatted 

Binary 

LP : <DFJ? : FILE 

Dumps FILE to the line printer 
in octal word format, but reads 
FILE in unformatted binary mode. 

6.2 i 

OUTPUT SWITCHES 


/AS 

ASCII 

LP:/AS<DF:FILE 

Reads FILE in unformatted binary 
mode and dumps to the line 
printer in ASCII mode; i.e., one 
ASCII character per byte. 

/BV 

Octal 

Bytes 

LP : /BY <DK0 : FILE 

Reads FILE in unformatted binary 
mode and dumps to the line 
printer as a sequence of octal 
bytes . 

/OC 

Octal 

Words 

LP:/OC<DF:FILE 

Reads FILE in unformatted binary 
mode and dumps to the line 
printer as a sequence of octal 
words . 

/RA 

Unpacked 
Radix-5 j2f 

LP:/RA<DK0:FILE 

Reads FILE in unformatted binary 
mode and dumps to the line 
printer in unpacked Radix-50 form 
format, i.e., 3 characters per 
word. 

None 

Octal 

Words 

LP: <DK0:FILE 

Same as /OC 
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INDEX 


/AS switch, 2-2, 2-4, 6-1 
ASCII, formatted, 2-1 
Assembler, 5-3 
PAL- HR, 5-1 
Assembling FILDMP , 5-3 
and Linking, 5-1 
Assembly listings, 5-1 


Binary 

formatted, 2-1 
unformatted, 2-1 
/BL switch, 2-1, 2-4, 2-6, 6-1 
Block numbers, 2-4 
/BY switch, 2-2, 2-4, 6-1 
Byte 

count, 2-3 
mode, 2-4 
status, 2-4 


/CH option, 2-6 

/CH switch, 2-1, 2-3, 2-4, 2-5, 
6-1 

Command, DO S /BATCH Monitor RUN , 1-2 
KILL, 5-2 
Monitor RUN, 5-1 
Command String 
format, 1-1 
input field, 2-1 
interpreter, 1-1 
output field, 2-2 
Command String Interpreter, 1-1 
CTRL/C key, 2-5 
CTRL/U key, 1-2 


DEC tape, 5-2 

Determining File Blocks, 2-5 
Device 

input, 1-1 
output, 1-1 

DOS/BATCH Monitor RUN command, 1-2 
Dumping 

blocks of data, /BL, 2-6 

entire files, 2-4 

lengthy files, 2-5 

Radix-50 formatted data, /RA, 2-6 


E error message, 2-4 
flags, 4-1 

EOF, End of File, 2-4 
Error message, E, 2-4 
Error messages, 4-1 
Errors 

read, 2-4 


/FA switch, 2-1, 6-1 

/FB switch, 2-1, 6-1 

Field, output string command, 2-2 

FILDMP 

assembling, 5-3 
linking, 5-3 
running, 1-2 
FILDMP. LDA, 5-4 
FILDMP. OBJ, 5-3 
FILDMP. MAC, 5-1 

File Utility Package, PIP, 5-1 

Flags, 4-1 

Format 

command string, 1-1 
Radix-50, 2-3 
Formatted ASCII, 2-1 
Binary, 2-1 
Formats 

output, 2-3 


Input 

device, 1-1 

field, command string, 2-1 
file specification, 1-1 
switches, 2-1, 6-1 


Key 

CTRL/C, 2-5 
CTRL/U, 1-2 
RETURN, 1-1 
KILL command, 5-2 


Line number, 2-4 
Link Linker, 5-1, 5-3 
Linker, Link, 5-1, 5-3 
Linker overlay builder, 5-3 
Linking FILDMP, 5-3 
load maps, 5-1 
procedures, 5-3 
Listings 

assembly, 5-1 


Maps, linking load, 5-1 

Mode byte, 2-4 

Module 

load FILDMP. LDA, 5-4 
object, 5-3 
Modules 

source, 5-1 

Monitor RUN command, 5-1 
Multiple output file 
specifications , 2-3 
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Numbers, block, 2-4 


Top address 37450, 5-4 


Object module, 5-3 

/OC (Octal) switch, 2-2, 2-4, 6-1 

Output 

device, 1-1 

file specifications, 1-1 
formats, 2-3 
switches, 2-2, 6-1 
Overlay builder, 6-3 
cissembler, 5-3 
Linker, 5-3 


Unformatted binary, 2-1 
switch, 6-1 
UIC, 5-5 

User Identification Code (UIC) , 
5-5 


PAL11R Assembler, 5-1 
Paper tape, 2-3, 5-2 
PIP, 5-1, 5-4 

File Utility Package, 5-1 
Procedures 
linking, 5-3 


/RA switch, 2-2, 2-4, 6-1 
Radix-50 format, 2-3 
/RE (restart) , 2-5 
Read errors, 2-4 
RETURN key, 1-1 
Running FILDMP, 1-2 


Source modules, 5-1 
Specification 
input file, 1-1 
multiple output file, 2-3 
output file, 1-1 


Status 

byte 

, 2-4 



S 2 0 2 , 
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S20 3 , 

4-1 




S20 5 , 

4-1 




S206 , 
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S 2 5 6 , 
Switch 
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/AS, 

2-2, 

2-4, 

6-1 


/BL, 

2-1 / 

2-4, 

2-6, 

6-1 

/BY, 

2-2, 

2-4, 

6-1 


/CH, 

2-1, 

2-3, 

2-4, 

2-5 

/FA, 

2-1, 

6-1 



/FB, 

2-1, 

6-1 



/OC, 

2-2, 

2-4, 

6-1 


/RA, 

2-2, 

2-4, 

6-1 


/RE, 

2-5 




Switches, 2 

-1 




input, 2-1, 6-1 
output, 2-2, 6-1 
Symbol tables, 5-1 


Tables, symbol, 5-1 
Tape 

DEC tape, 5-2 
Paper, 5-2 
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HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming 
notes, software problems, and documentation corrections, are published 
by Software Information Service in the following newsletters. 

DIGITAL Software News for the PDP-3 and PDP-12 
DIGITAL Software News for the PDP-11 
DIGITAL Software News for 18-bit Computers 

These newsletters contain information applicable to software available 
from DIGITAL'S Software Distribution Center. Articles in DIGITAL 
Software News update the cumulative Software Performance Summary which 
is included in each basic kit of system software for new computers. 
To assure that the monthly DIGITAL Software News is sent to the 
appropriate software contact at your installation, please check with 
the Software Specialist or Sales Engineer at your nearest DIGITAL 
office. 

Questions or problems concerning DIGITAL'S software should be reported 
to the Software Specialist. If no Software Specialist is available, 
please send a Software Performance Report form with details of the 
problems to: 

Digital Equipment Corporation 
Software Information Service 
Software Engineering and Services 
Maynard, Massachusetts 01754 

These forms, which are provided in the software kit, should be fully 
completed and accompanied by terminal output as well as listings or 
tapes of the user program to facilitate a complete investigation. An 
answer will be sent to the individual, and appropriate topics of 
general interest will be printed in the newsletter. 

Orders for new and revised software manuals, additional Software 
Performance Report forms, and software price lists should be directed 
to the nearest DIGITAL field office or representative. USA customers 
may order directly from the Software Distribution Center in Maynard. 
When ordering, include the code number and a brief description of the 
software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user 
library and publishes a catalog of programs as well as the DECUSCOPE 
magazine for its members and non-members who request it. For further 
information, please write to: 

Digital Equipment Corporation 
DECUS 

Software Engineering and Services 
Maynard, Massachusetts 01754 




DOS/BATCH File Dump 
Program 

DEC-ll-UFLDA-A-D 


READER'S COMMENTS 


NOTE: This form is for document comments only. Problems 

with software should be reported on a Software 
Problem Report (SPR) form (see the HOW TO OBTAIN 
SOFTWARE INFORMATION page) . 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent. 
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